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' ' ■ , ' . 1 ■ SKfiTION 1. INTROIILICTIOH • , 

■ r.. . ^ i . , i ■ ■ ' 

The BASiC Instrud Clonal Program <BIP) ia a soph 1st IcitRcl coniputGr- 
bflsed laboratdry for Instruction in elementary programming in the BiSIC 
ianiuajc. ^t was developed an experimental sysCem on the IIISSS PDP-10 
researdh computer facility in a Bpecialjzed high-level programming languase 
called SAIL (Rolscr, 1976), vhlch la presentLy available, only to the Jlp-lO 
wL^nH^^f ^ P"P°«^1 -"^de to rewrite BIP m a more mnchine- 

Independent laniuage, so that it couM be inipleniented 'on other (notablv 
smaller) systeinB, ' ' v i.aijj.y, 



1.1 



Descrlpclon o f tlie BASIC Instructionnl Prop tam 



h.H tutorial , ppogramming laboratojy designed for studenti who have 

had no previous tralMng in programming. The.e gtudetits work their problems 
nro™" whfJ constant supervision of the instructional 

program,, which offers hints or asslatance at their request. BIP monitors each 
students, programming attempts, eontl,m,aUy updates Its model of the student'" 

S olofin n'.'i"?/^''>'r""'""^""^^^ ropreientatlon of the Curriculum 
atuLnt sanction of the progrartn,lng.problc,ms Slvcn to the ; • 

Immpd?^;. 1 1J r r"'' - °" Interactive environment, the student receives 
.immediate feedback about any ayntax errors and Information about other errors - 
as soon as they are detected. These featurea keep the student from golnR too 
ar down the wrong track without some warning. BIP 's interpreter Is bulft 
into the InstructlonaL prografti so that further assistance is available after 
the first error rnaagage. > , 

BIP has been used successfully by students at Stanford, at the U S ^ 
facility! '"^' at local colleges with acoeBs to the IMSSS .instruct l^nal 

Avi,/^^" fJLfP^^*"' developed in SAIL and described In Barr, Beard . and 
Atkinson (1976), is cornposed of ten major subaygtemsi 

BASIC Interpreter— ResponBible for Identifying syntax and runjclme 
errors. Includes standard, debugging and editing commands. 

Pro gram error analyzer CERROR DOCTOR)— Identifies the structural ■ 
bugs Irt student programs. * ' 1^ . 

HELP system-gGives advice and references to the of f=Iine student 
manual baaed on cues from the first two systems. 

Solution Checlcer— Verifies that the student's program does In fact : 
solve the problem, ; , ' j. ' lacc 

The c uf T lculum and 4e BIP Student Mmufll--A large set of program- 
ming problems, with hints and model -solutions, and the off-line manual 
cnat students tise as a reference durlnj the course,. : 



1. 



2. 



3, 



5. 



^' Curriculum Informatio n Network and student model— Do.^^r-ih»^ the 
structure, of the curriculum and current abilities of the student 
so that task sequencing can be Individualized. ■ ' ."' 



7. 



InHtructibr/SupervlgQr cdpabllit i^es—Exampieij are lenroiling atudontfjp 
monitoring their progi?las, sending meBsagea and jreapondlng to com- 
plaints. , ' i 



8* The graphleg debug ging packa ge (FLOW) and grap hics flowchar ting 
optidn (REP) . 



Tii€ data cQUectlon faclllt:v- -^U|jgd to save "protocbls j-' or reccprda 
of ^student sessions. ' 
" . . i> _ 

10. ^he student file storage syste ms-Used to allw students to save up 
to ten of their prograins at a time, - 

FLOW and REP (8 above) are the only parts of SAIL BIP that have not yet been 
written for miNSAIL BIP. Before they can -.]be 'implemented, *a machine- 
Independetit display package must be written to access termlnal-deperideat 
procedure^. ' ^ 

1.2 Qriglnal Plan: To Rewrite in BASIC 

The original proposal was to rewrite the BIP inatructlonal syetem in 
the BASIC prograimiilng language , the sama language that BIP teaches. Since 
BASIC' 1b available on more computer systems than any other progranttnlng 
language, this would allow the test and evaluation of the BIP course In a 
;wlde eommunlty of users. Further , BASIC is easy to Implement on a sinall 
(relatively cheap) cbmputer, fuily Interactive, and fairly easy to learn. 

The BAS'tC language however, 1$ not well suited for the developinent of 
programs as large and compleK as the BIP system,. It has neither the ver-- 
satllity nor the power of ALGOL-llke languagee^ (e,g., SAIL and LISP). To 
implement the instructional laboratory in BASIC would require considerable 
modification, and redesigu, ^ ^ ' . 

' ' ' - " . ' ■ . ' ^ 

Anocher difficulty in trying to rewrite BIP in BASIC id that , although 
it Is available on almost all general^purpose computers^ most npnufacturers 
have developed a unique dialect of the language. This has causeaxserlpus 
p^obleiBa In transporting' even small BASIC programs from one site to another, 
since syntaK changes are almost always necessary. Changes of this nature to 
a prograBi as large as the giP syst^in would make a truly irarisportable system 
unfeaiible- ^ ' . 

Finally, there are considerable difficulties Invblvid in rewriting the 
code in BASIC for a small computers primarily because qf the restrictions of 
the BASIC language (no recursion^ no' string scanning- ^Md segment slz^^, 

BIP's Curriculum Information Netwrk and the student raodeL (which fortn the 
data baie of the task-delection algorithm) make eKtensive use of the associa- 
tive data structures available in the SAIL langu&gei and the syntaK parser 
la thoroughly recursive. These aubsystenis wpuld be very ^dlf f icult to Impls-. 
Mnt in BASIC 




1*3 Final Lariffuaf^c Daciflloa; MW 



MAINSAIL CMAchin«.-.rNdepftndetit LiL) (Wiic^^ 1977a) la a loniagQ 
being developed at. the Startford Unlkrslty Medical Experimental (iuMEX) 
Computer Facility. MENSAIL haB evkved from SAIL. wWch was deviopad 
Jatt * * "^^^ Stonfoid'a Ar^tlflclal IntQlligencc Laborator/ 
bAiL <J^B deBlgned for execution oii a PDP-IO computer witli the TOPS-IO 



operating ayatem, MAIMSAIL, ae re 
abilities similar to tlioae in SillL 
sya'tem (Wilcox, l'g77b). ' It la del 



:lected In its name, provides caj)- 
liidepflndcnt of the underlying cOniputer 
' — — __„Jgned to be powerful and efficient, wtfrb 

a high degree of portabiatty on a Iroad class of computer^. Tn fait lu 
design goals are met, on^/ prog raiii written In pure miNSAlL will be !ab e to 
be nin on artx coniputer (Includ Ing' .4ome minicomputers) that has a nilMSAIL 
compiler-regardless of differing tford glEes. operating eystema, nuWblrs 
and types of regiatersy atc. It li designed for the deveaopment of port- 
able software^ such tliat prograini ian be transported, «tth no alteration 
among all Impleinentatlona. ' 



Any general-purpose computer 
auitable data formats, and addressa 



*;lth a reasonably powerful Instruction set, 

, . . jalllty, aufflclent address space, a flle-« 

system, and an Interactive terminal, should be capable of support ins an 
^plementatlon of MAINSAIL. , IIAI^SWI Is currently running on PDP-lO's 
Sp lif Pw^ operatlni systems, anils undir development" for 

y^*" operating ayfltjems.- RTll, RSXll, and UNIX. A number of 



other Impleneneatiotis <e.g 
consideration. 



TI-99 



0, HP-3000, lBM-370, IOTERDATA) afe under 



Because It is aitiiUar to SAIL, and : because It was designed exoresslv 
for porcabllity^ MArNSAlL was found to'be Ideally suited for the ttans- - 

t computer: that supports MINSAIL will be able to run 

Che ^^INSA1L veralon of BIP wlthoiJt modifications. 

■ " ' ■ ' ■ ■■ S 



2*1 



I 



nv INTO htAlNSAIL 



SRCTION 2. 1 THK REWRITlNr, OF 
.Initial Code Compatyjle with Hot li SAIL j ind MAINSAIL idompilerB 



When the MAINSAIL tranalatlon was begun 



ftrst implementation, oif a PDp-10 (the compuier on whlch'tho trflnsslation 



In October 1976, MAlNSAIL's 



was done), was not , yet 4ompleted. Therefore J ' for several rnoriths. It was 
uftS^fff^ " "f^'^° acceptable do bo,th the/SAIL and the 

MAINSAIL compllera. Trfls was accomplished b>i writing pure MAINSAIL code 
aa much as posglble, but using mflcrog and procedurcB to describe to the 
SAIL compiler the SAIL □qulvalents of various MAINSAIL Bystem procBdureR . 
reserved words , etc. Conditional compilation wae also used occasionally- 
, that Is,: someulmas two segments of code would be written to do the same ' . 
type of thing, one for the SAIL compiler and the other for the MAINSAIL 
CompUer (« macro that waa set Just before using either compiler deter- 
mined which segmeht of code was compiled). ' 

, ^ Thus, the SAIL compiler "understood" the MAINSAIL code, and the modules 
■that were written during the first few months of the trmslatlon (notably 
Che parser and the interpreter) were successfully compiled and tested by 

. Che SAIL compllerx Then, in April 1977, when MAINSAIL was up on the PDP-IO 
. BIP waa compiled and run more often with the MAINSAIL compiler. It was 
still occasionally compiled with SAIL because of the availability of a good 
symbolic debugger, called MIL (Reiser, 1976). (A debugger for MAINSAIL is 
now being written.) However, since May 1976, thS MAINSAIL compiler has been 
used eitc usluely, and most of the code written since then has been solely 
for Che MAINSAIL compiler, , '==^J' 

2.2 The Main Data Structurea • 

BIP was written before the record data structure capability was added 
to SAIL, at p slme when LEAP was the'only facility available for data storage 
and retrieval other than arrays. Aa mentioned in the Introduction. SAIL BIP ^ 

wfrMQAT?*" °^ structures that werfe replaced by recdrda in the 

MAINSAIL yerston* 

LEAP provides high-level data structures, such as sets and lists, and 
operations on those structu.ies, such as union, intersection, removal and 
Insertion of elements, etc- ,LEAP also has an associative data store of 
triples that allows one to store and retrieve informatiot, based on relations 
between specified elements, Take, for example, a "Skill of" relation If 
the programmer has formed associations such as "skill of raBka Is 2" and 
f^liif t^J'" then perform searches to find the set 

of akllls in task 8 by having the, LEAP search routines return a set of 
"risks!" component is "Skin of" and whose aeconfl component is 

Records provide a meana fay which a number of closely related variables 
may be allocated and manipulated as a unit, without the overhead or llmlta- 
Clons. associated with using parallel arrays and without the restriction that ' 
Che variables all be of the same data type. Each record is an instance of 

lleldrf?""^ "f'^T^'^^r' "^^^^ " a template describing the various 

fields, of a record. In the example above, instead of forming a "Skill of ' 
Tasks association for every sklU in task 8, and then later asking LEAP to 
form a . set of the akllls in task 8 by searching for all triples whose first 



^mp$nmt is "Sfclli of* and whose second component la "TaskS/* we cowW 
Tjuiid up and keep ^he *-SGt'' readily available dutaelves, by putting th»(^' 
tagk 6 skills In ^ linked liat of recordB, A record class called '^iltlll" 
could bo defined to haVe two fields^ one for a skill number and the other , 
fp;r a pointer to the ne^t repord in a 4 Inked ll^t of skills. We could 
i0m ^ fcecord of the clase "skiir' for each skill in task 8* and if th^ 
BkllXe ate 2p 5p 12* then the linked list could be pictured as 

p^~----i ^^^^^^^^^ 

I 2 - |S j - \-> ! 12 I j 

L^»„^-.^i L^^^^^^^i . 

One of the ni^j^^j^ data structures in J4AINSAIL, BIP is a linked list pf 
recaufds* one for taak. The thirteen fields oi each record hold yariou}^ 

Infai^Taation needeq bIP* Including the task nAme"_ its number, .the locateiqtii 
in TASKS file q| its description^ inodel solutloni and hints, a polntM 
to tb^ linked list of Its skills (ae^ described above) , etc. See Sectiori^ 2 , 3 . 
Qt Kate 3 (1978) for a Pi^re detailied description of the task record^. 

tiRAf was us^d eKtensiVely throughout the SAIL version of BIP, mot iie^as^ 
BntiXy because It i^^g the b^st of all programming structure^ for wh^t was 
n^'adedii but becaw^^ the only major data storage and retrieval method,^ 

othiar than arraya/ Q^^ilabl^ In SAIL at the time, the high-level LSAP 
BtjTuCSturts have to ^e very general — ^uaually more general (and thus X^is 
efficient) than f^^eded in any particular Instance in BIP, and the L^AF synca:^ 
la often confusing obscure. MINSAIL does not support LEAP becaus^a th^ 
ruiffttim^ Code for it would b^ excessive and because most of. the capabiltti^^ 
prwlded by LEAP easily Implemented with recoras* The use of records 
insMud of LEAP in the MAINSAIL version of BIP did not cause any lossi in 
clarltyt stoplicity.^ or f l^xibilAty-^ln fact, it^led to a number of ^implUU 
Cations, both conceptually and in implementation. 



2*3 yilj Names 

» . « * .t . . . - . ^ .. 

File namaa ot\ different computers have different length and ^sipaJf ting 
chaciie^tef gpecifiCatipns* pn some computerB, Chey ^ay be q maxlmun} of Bi^^ 
characters long; others ^they may be almost as long as the; user dtiitraif 
Soma, computers allo^ the starting character to be either a number or a lattfe^j^ 
Whiljre^^ others ap^Qify that it muat^ba onijf a letter. Thus, in o^di&r for 
MAINSAIL BlP file itamea to be truly '"Mchlne-indep^rtdent,'' they all bia| in 
^ vicK letters and ^te a rtaKlmum of six characters, in -length, \ 

The format.ot gtydent history file names, for eKample, is <Btuimt 
mmh<^t>^mr in the: sail version of 'BIP. In the MAINSAIL varsionp it la 
:MST<atudent numbers ^ (Note that 999 is the highest possible student wumb*&:r,^ 
^Ince & four-digit ^yjnber Wu Id make the history file nathe seven chatmt&T^ 
■ long.) ■ - ■ . \ ■ . ^- . - • ."■ 

M another eK^uipie, students are allowed to save up to ten of th^it 
progr^s for later ugg^ The file names for these in SAIL BIP" Is 
\- ' ■ . ■ ^ ^ . ■ V ■ 

i . '^Student number^ *<Whatevar name the student assigns to the ^%:Xm>'* ' ^' 

'\ . ■ ■ ■ . • • ■ • • : ^ • ^ . ' • • • 
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In the MAINSAIL version, ;stud<snts may still u.-islgn wliatt<vf.r „ntnaa thov 
wish to chHlr progrnm«, but the file names imdar wdlch tho proHf/imri arc 
actually aavod aro completo|lv different. They ava of tfif fop,nflt s'<«Luc!Gnt 
number >F<f He nun,bor> , whcRe <Jile number> 1b a riumbor bctweon 0 and 9.- 
A ten-element array coHatl itgmj holdB the-nam,.., asslgnad by the studonts. 

OPERATOR then stuPlle [0] ^ "OPERATOR", and the name of the ftle actually 
saved^ls S88P0. Between m^mhons, the student-aaaAgned names ate saved In 
the student hlscory, (Section, 3.3 of Note 3, 1978), 

2,4 Space Savins ! « 

f ®P Requires a very large space, In particular for 
, strings. All the model golutlonfl and task deacriptionB lot the 93 proBram= 
mlng tasks are kept in memory-tesldent string arrays. So^are all the error 
messages (nearly lOO) . th.e mp messages (nearly 4o. some of which ate 300- 
, characters long) and one^llne descriptions of each of flr progr^nuning 

skills. The PDP-10 has enough space for these «nagfl.. but „iy otP corn= 
puters, especially mlnlcQmpuECTs, *io not. Therefo];,a, spflCa-„avinp measures 
were taken in the MAIN SAtt vwa ion of BIP. ' sa^^ ng measures 

Instead of being staired in string arrays, all the fee^p messageg error ' 
messages, and skill descripcJms are on a file called mM. |ach gr&up of - • 
messages is on a separace paga of MSGS, in order, -^m beilnninS of each 
page has pointers to the itart of air the messages on t-hat page. Given a 
page and a message numb ar, a.apaclflc BIP procedure will copy the appropriate, 
message from Che file MSGS, apF op idue 

All of the task inform»cioia-_task descriptione, hint solutions. 
TVI k ^-\ °7a^^ file msKS, and the currlculu/data structure (Section 
2,2 of Note 3, 1478) contains polntera into that fUa so that .Appropriate • 
Inforraacion can be efflcietitly accessed when needed. 

2.5 History Files 

Each Individual student's personal history Hl^ is a elata file used to 
store information about the acudent's current atat« . (what task he is cur- 
rently working on, how many taiks completed so fajr, eWf) , and past necfbrinance 
on tasks and skills. SAII, BIF ,sas 36=blt ^ords d s.ve Inf^'Jtion'i^ .™ 
ttnlV^ f« each task and £m nmh-akai. The 36^blt assumptiprt Is clBflrly 
etc Slflqfr^^f • f * aoWC computers .have 16-bit ,«rda. Some 32-bit ^ords. : 
, etc . MAltlSAIL has a data ftyp^ called bi£t for rep,„entiflg a ahott sequence 

H • ^"Pf « a« lewt 16 bits (indepenclwt of the'^opd size of 

^istory^rSlNllk^Mpf"^^^ "^^^ ..ch element o£ the student 

2.6 Data and yime Information! ■. " ' 

.«.h f^^t^^J^H """^ tlme'ln«oraat±on, such as the amount of tile ap^nt on 
to the^«P T° 'S'/^" sign on, etc.,. would fee umiul mi of interest 

to the BIP, Supervisor. Thla ma:<Jone in the SAIL version of BIJ. Again, 
this type of infffrmatlon i« se^fe^aed in a machine-debendent m3\.^er L-i2l ' 
TENEX.JSYS. ealXs. th. miNSAlL version, two sta^jr ' • 



procedures (allowed by t'he MAINSAIL qualifier CODED) are all that are 
needed fot each implemenCation. So far ^ they have only been written for * 
the PDP--10* ' / ^ ^ 

Some impLi^entatlons will be unable 'to provide date and time Informa- 
tion at ail', B,m conditional compilation Is used to' allow for either sltua^ 
tlon. Before compilation of the BIP syaiem, a niacro called havePaTime must 
be Set to tRUE if the iiLachlne-dei^endeht procedurea have, been written for ^ 
the Implementation, and FALSE .otherwise* If PALSB, then all the code for 
calculating, printing, mi saving the date and time information is simply 
not com~^ * ^ ' 
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. sections; improvements over the Said version of sip 

The fact that che, MAmSAlL ^^ersion of bIP ig aac lirteL Independent . 
while the SAIL versl^on 16 Itnitted to a PDP^IO v^ith a lENEX operating ays tent ■ 
and yet doas all thac the SAIL version does CflcclucUng the graphic progja.^ ' 
mlng aids) is of course itself a tremendous imp tovcment . But a number of ' 
other improvements In efficiency and design ^er^ also made. Analysis ^f th. 
SAIL version prior to writing the MAINSAIL version sparlced ideas f or Imp^pv .d 
code and algprlthms and reveaUd some bugs, ^'htch were. promptly fixed. 

The SAIL version of DIP was written, expanded , and Improvfid by a nuiflbel 
o people over a,pariod of years. The project described in this repor p o! 
vlded an ideal opportunity for one person to anmi^, Che system developed 
by thpse people, learning about its design, its sttfrngth a and weakness a 
and then to rewrite it all,', using what had been wfitten as abase and yal 
redealgnlftgva^goritfima and data structures where iirtpro-vements could be m*de 
(or where changes had to he made for niachlne=lndopendence). Important s^ace- 
saving meagures as described tn Section 2.4. ulcen , and virtually ^v.r^y 

procedur.e had minor unprov^eMs in code that contributed to the overail im^ 
provement in efficiency and design. 



or redesign was required In order to use corcl data stTucturea ii, 
place of Che extens ively=used associative data atructuies (lEAP) in the 
SAIL version. The new design could also be .ar^mu^nd an ln,proven,ent in 
""■i i!r, implementatldn. ,An extrerne exaaiple is the ERRDOk mod^i^ 

Me SAIL version used a number of complicated lE^P fltruccur'es, most of yhich' 

^r^lponn^ ""'^^ ^^'"'^ function of chp mmOK procedures. (At the 
ti^e that ERRDOK waa written, there was some hop« oi ualng its compUca Id 
in ar^tlon about Che structure of th6 stude^c 's ,,^ir^ In a mof e 8ophls,cic^.t 
MAmfc ch«=^er.) Only two small linked lista of records are 'used In U 
MAm^IL version to perform, the same functions actually linplemenced in 
SAIL fterslon (see Section 6 of Note 3, 1978). 
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SECTION 4. CURRENT STATUS AND POSSIBLE ■^UTURE DEVELOPMENTS 

the subsystems In the S.AIL vereton of BIp thae were liated in 
■^ecti-Q-n 1.1, excepc for the term inal-dependent Eraphtca features, have 
, oejn tmplBmmtM in MAINSAIL. hUlNSAIL BIP is capable of running on all ' 
PDP-IO comparers that have eUher TENEX cr TOPS-lQ operating systems, and 
^t nilbB put up on PDP-il's when HAZmklh la aValUbLe on them. It should 
»e able co run on , any computer ttiat has ' HAIMSAlL- ' 

SAr ir^?'"' "^''"^^ ^^-'^ ^"^^ been modified to conform 
^Itltne MAInSaiL version of bIP. Although BiP Is a "self -Instruct lonal" 
jystcm, a Supervlflor e Manual haa been written to explain the goals, methods 
a^nd operation bf tRe aysteJn to supervisory Personnel (Noce 2, 1978). Al«io ' 
documentation of all necessary cleric.,! capflbllltlea , : such as ' 

LIS'fnrL' "™^fi"8 students.. awfflliMng t^lr progress, and adding 
s P^ciaJ- Programming casks. 

m^J^'^tt' documentation has been ^.^rltcen to describe all ,tHe programming 
h^duile^ that comprlae the MAINSAIL Bip syatflm includins the BASIC interpreter 
tjetask.selection algorithm, the curriculum, the solution checker, the help 
pstem, and collection of relevant student performance da t a (Note 3 1978) 
A detailed description of the information aaved in student histories and of 
tne , cur rtculiim data structurea Is also Included. 

ntp P^^J^J, possible additions and inipi-oveinents «ould Include maklrtg MAINSAIL 
aia °i T V ■n^^hines. and vritlng a graphics display pack^ 

rn^TM th't^i^ procedures so th^t th« gf^Phlcs debugalrig package 

(FLO-H) ^md the graphics f low^charting option (reP) could be implement^- 
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